Talarm

Section: Oct. 1, 1991 (2)
Updated: MiNT Programmer's Manual
Index Return to Main Contents

NAME

Talarm - schedule an alarm to occur

SYNOPSIS

LONG Talarm( LONG time );

DESCRIPTION

If time is greater than 0, schedule a SIGALRM signal to be delivered to the process that many seconds from now. Note that unless a handler for SIGALRM has been established by means of the Psignal function, then the signal will kill the process.

If time == 0, then any previously scheduled alarm is cancelled.

If time is negative, then no change is made to what alarms are scheduled; in this case, only the returned value (the number of seconds left before any alarm) is of interest.

RETURNS

If an alarm had been scheduled before this call to Talarm, return the number of seconds remaining until that previously scheduled alarm.

Otherwise, return 0.

BUGS

Internal calculations are done in milliseconds, not seconds, so the returned value is not exactly accurate.

For the same reason, setting an alarm more than 2 million seconds or so into the future will not work correctly.

This document was created by man2html, using the manual pages.
Time: 11:14:11 GMT, June 22, 2025